ELECRAFT PX3 PROGRAMMER'S REFERENCE 


Rev. A6 (See Appendix A for change history) 


Command Set Overview 


The PX3 provides a set of remote-control commands to control the most important instrument functions 
(Table 1). Details on individual commands start on page 2. PX3 macro import/export/edit operation starts 
on page 9. 


Table 1. PX3 Control Commands. 


[= | ProductID_ | #FNX_| Function key execute | #OSBP | OSB Phase | 
|BR_ | Baud rate set | #MAA | Marker A Adjust | #REF__| Reference Level | 
Baud rate set 
Center frequency 
Internal use only 
Internal use only 
Internal use only 
FaFNL | Fontion ey label [#0585 [OSB Amps | 


The Command Tester screen of the PX3 Utility computer program is a convenient way to try individual 
control commands. You can also define macros, which allow sending strings of PX3 and/or KX3 
commands with a single mouse click. The Capture Image screen uses the #BMP command to upload 
the current PX3 screen to a standard bitmap graphics file. See the PX3 Utility help facility for details. 


When a KX3 is connected to the RS232 "ACC1 XCVR" port, both KX3 and PX3 commands can be sent 
from the same computer program. For example, #RVM;; returns the revision number of PX3 firmware 
and RVM; returns the revision number of main firmware in the KX3. Sending those two commands is a 
handy way to check the connectivity of the two RS232 ports on the PX3. If you get a response to #RVM; 
then the PC port is connected; if you get a response to RVM; then the XCVR port is connected as well. 


Command Format 


Commands sent from the computer to the PX3 are considered either GETs or SETs. GET commands are 
used by the computer to get information from the PX3; the PX3 will then provide an appropriate response 
message (RSP). SET commands are sent by the computer to change the instrument's configuration or 
initiate an event. Commands with an incorrect format or an out-of-range parameter are ignored. A SET 
can be followed by a GET to verify the new settings. 


SET commands use 2-4 characters, optional data fields, and a terminating semicolon (;). Examples: 


#AVG05; Computer turns on averaging with a time constant of 5. 
#DSM1; Computer selects spectrum+waterfall display mode. 


Many SET commands have a corresponding GET command, which is just the command letters with no 
data, plus the semicolon. The data format of the response message from the PX3 (RSP) is usually 
identical to the format of the SET data. Exceptions are noted in the command descriptions. 


Characters sent to the PX3 can be in either upper or lower case. The PX3 always responds with upper 
case. 


Command Reference 

This section describes all PX3 GET, SET and RSP (response) command formats. Unless otherwise 
noted, the GET format is just the 2 or 3 letters of the command followed by a semicolon. The SET and 
RSP data formats are identical unless otherwise noted. All commands must be followed by a semicolon 
except where noted. 


= (Product identification; GET only) 


RSP format: PX3 (main firmware executing) or px3 (boot loader ready to download new firmware). 
There is no "#" or semicolon in either the query or the response. 

#AVG (Averaging Time, GET/SET) 

SET/RSP format: #A VGnn; where nn is 00 (average mode off) or the averaging time constant, 02-20 
(average mode on). 

#BMP (Bitmap upload, GET only) 

RSP format: [bmp]cc where [bmp] is 131,638 bytes of binary image data in standard .BMP file format 
and cc is a two-byte checksum. Note that the response does not include the command name and has no 
terminating semicolon. The checksum is the modulo-65,536 sum of all 131,638 bytes, sent least- 
significant byte first. 


#BCI (Beacon Interval; GET/SET) 


SET/RSP format: #BCInnnn; where nnnn is the beacon interval or time to wait between beacon 
transmissions, in seconds when beacon mode is activated 1 — 3600. 


#BCL (Beacon Location; GET/SET) 


SET/RSP format: fBCLnn; where nn is the text memory location to send when beacon mode is activated 
1—50. 


#BCN (Beacon Mode On/Off; GET/SET) 


SET/RSP format: #BCNn; where n is 1 (active, on) or 2 (disabled, off). 


BR and #BR (Baud Rate of the PC RS232 port, SET only) 


SET format: BRn; or #BRn; where n is 0 (4800 b), 1 (9600 b), 2 (19200 b), or 3 (38400 b). The PX3 
Utility program automatically sets the PX3 to 38400 baud for downloads, then restores the baud rate to 
the user's selection (that was made using either this command or the PX3's RS232 menu entry). Note that 
the RS232 port that connects to the KX3 always runs at 38400 baud. Any BR command that is received 
from a host computer affects the baud rate of the PX3 (on the RS232 port that connects to the PC), not the 
KX3. 


#CAL (Calibration signal on/off, GET/SET) 

SET/RSP format: #CALn; where n is 0 (calibration signal off) or 1 (calibration signal on). The 
calibration signal generated is based on the current KX3 band. 

#CTF (Center Frequency, GET/SET) 

SET/RSP format: #CTFsxxxxxxxxxxx; where s is +/- and xxxxxxxxxxx is the center frequency in Hz. 

s can also be a space in lieu of +. Example: #CTF+00014060000; sets the center frequency to 14060 
kHz. If the specified frequency is outside the range the PX3 can tune to, the action is undefined. A value 
of zero sets the center frequency to the main VFO frequency of the transceiver. For transceivers other 
than the KX3, the center frequency is interpreted relative to the frequency the transceiver is tuned to and 
may be positive or negative. 


#DSM (Display Mode, GET/SET) 


SET/RSP format: #DSMn; where n is 0 (spectrum only) or 1 (spectrum + waterfall). 


#FNL (Function Key Label, GET only) 


GET format: #FNLn; where n = 1-8, for keys FN1-FN8. 
RSP format: ffFNLnccccccccc; where n = 1-8 and eeeceecce are the 9 ASCII characters in the key label 
for FNn. 


#FNX (Function Key Execute, SET only) 

SET format: fFNXn; where n = 1-8, for keys FNI-FN8. Executes the function assigned to the key, if 

any. 

#FXA (Fixed-tune Auto-adjust Mode, GET/SET) 

SET/RSP format: #FXAn; where n is 0 (Full screen), 1 (Half screen), 2 (Slide) or 3 (Static) to specify 
how far the PX3 center frequency moves when the KX3 VFO A is tuned off screen in fixed-tune mode. 
#F XT (Fixed or Tracking Select, GET/SET) 


SET/RSP format: fFXTn; where n is 0 (Tracking mode), or 1 (Fixed-tune mode). 


#LBL (Labels on/off, GET/SET) 


SET/RSP format: #LBLn; where n is 0 (FN key labels off), 1 (FN key labels on) or 2 (text decode on). 


#MAA, #MBA (Marker Adjust, SET ONLY) 
Adjusts the Marker frequency by either adding or subtracting a value. If the marker is turned off, the 
marker frequency will still be updated. There are two ways to use this command, either specify an 
adjustment selection or use an internal value which is based on the current span and mode. Specifying the 
adjustment uses the same values as used by the K3/KX3 UP and DN commands. Usage: #MAAsn 
s = + to increment, - to decrement 
n = 0 adjust by 1 Hz 


n=1 10 Hz 
n=2 “ “ 20Hz 
n-3 “ “ 50Hz 
n-4 “ “ | kHz 
n=5 “ “ 2kHz 
n=6 “ “ 3kHz 
n=7 “ “ 5kHz 
n-8 “ “ 100Hz 
n-9 “ “ 200 Hz 


The other way to use this command is to simply give the sign, or direction and allow the PX3 to 
determine the adjustment based on the current span and mode: 


#MAAs 
s = + to increment, - to decrement. The step size is automatically determined 
by the current span and mode: 


USB, LSB, AM & FM 

Span < 5 kHz — step = 10 Hz 

Span 2-9.99 kHz — step = 20 Hz 
Span 10-49.9 kHz — step = 50 Hz 
Span 50-99.1 kHz — step = 100 Hz 
Span 100-200 kHz — step = 200 Hz 


CW & Data 

Span < 5 kHz — step = 2 Hz 

Span 2-9.99 kHz — step = 10 Hz 
Span 10-49.9 kHz — step = 20 Hz 
Span 50-99.1 kHz — step = 50 Hz 
Span 100-200 kHz — step = 100 Hz 


#MFA, #MFB (Marker A/B Frequency, GET/SET) 


SET/RSP format: flMFASXXXXXXXXXXX; or #MFBsxxxxxxxxxxx; where s is +/- and xxxxxxxxxxx is 
the marker frequency in Hz. s can also be a space in lieu of +. Example: #MFA+00014060000; sets the 
marker A frequency to 14060 kHz. If the specified frequency is in a different band than the KX3 is tuned 
to, the action is undefined. A value of zero sets the marker to the main VFO frequency of the transceiver. 
For transceivers other than the KX3, the marker frequency is interpreted relative to the frequency the 
transceiver is tuned to and may be positive or negative. 


#MKA, MKB (Marker A/B on/off, GET/SET) 


SET/RSP format: fMKAn; or #MKBn; where n is 0 (marker off) or 1 (marker on). The last marker to 
be turned on automatically becomes the active marker, meaning it can be adjusted with the knob and is 
the one that responds to the QSY command. If the marker was off-screen before executing a marker-on 
command, it will default to the center frequency. 


#MSS (MSD Screen shot, SET) 


Creates a bitmap copy of the LCD screen (screen shot) and saves it to the MSD flash drive (thumb drive, 
flash memory stick). Each time the screen shot is performed, a new file is created. Filenames use a 
numeric format in which the first 3 characters are “PX3” followed by a 5 digit number, i.e. 
PX300009.BMP Note: while the PX3 is busy saving a screen shot, other commands will be 
received but not processed. 


#NB (Noise blanker on/off, GET/SET) 


SET/RSP format: #NBn; where n is 0 (noise blanker off) or 1 (noise blanker on). 


#NBL (Noise blanker level, GET/SET) 


SET/RSP format: #NBLnn; where nn sets the aggressiveness of the noise blanker algorithm, 1 = least 
aggressive, 15 = most aggressive. 

#OSBA (Opposite side band null amplitude value, GET/SET) 

SET/RSP format: #OSBAsnnnn: where s is the sign (+ or -) and nnn is the value. s can also be a space 
in lieu of +. Value range is -9999 to +9999. This is a per-band setting. 


#HOSBP (Opposite side band null phase value, GET/SET) 

SET/RSP format: fOSBPsnnn: where s is the sign (+ or -) and nnn is the value * 10. s can also be a 
space in lieu of +. Value range is 

-450 (-45.0) to 450 (45.0). This is a per-band setting. 


#PKM (Peak Mode on/off, GET/SET) 


SET/RSP format: #PKMn; where n is 0 (peak mode off) or 1 (peak mode on). 


#PS (Power Status, GET/SET) 


SET/RSP format: #PSn; where n = 1 indicates the PX3 is on. #PSO turns the PX3 off, but this removes 
power so #PS1 cannot be used to turn it on. Note that if the power-on jumper on the rear-panel I/O board 
is in the "always on" position, then the fPS0 command has no effect. 


#PT (Pass Through, SET only) 


SET format: ffPT; Sets the PX3 to pass-through mode, that is, the panadapter operation ceases and all 
data received on either RS232 port is passed through immediately to the other RS232 port without delay 
or modification. This command is used by PX3 Utility when downloading new firmware to the KX3 
transceiver. Pass-through mode ends automatically 20 seconds after the last RS232 activity. 


#OSY (QSY to current marker, SET only) 


SET format: #QSYn; where n is 1 (QSY ) or 0 (undo QSY). "QSY" means the currently-active marker 
frequency is transferred to the associated VFO on the KX3. MKR A controls VFO A and MKR B 
controls VFO B. "Undo QSY" means to return the VFO to the frequency it was on before the last QSY, a 
one-level undo command. 


#RCE (Relative Center Frequency, GET/SET) 

SET format: #RCFsnnnnnn; where s is +/- and nnnnnn is the offset in Hz which when added to the 
VFO A frequency becomes the new center frequency. This command is used to position the VFO A 
cursor on the screen. For example, if the current span is set to 50 kHz, #RCF+025000 will move the 
VFO A cursor to the left edge of the screen. (the center frequency moves up 25 kHz, which shifts the 
VFO A cursor to the left) 


RSP format: #RCFsnnnnnn; where s is +/- and nnnnnn is the difference between the current center 
freguency and the VFO A freguency. 


#REF (Reference Level, GET/SET) 

SET/RSP format: #REFsnnn; where s is +/- and nnn is the reference level in dBm, between -170 and 
+010 dBm. s can also be a space in lieu of +. For example, #REF-120; sets the reference level (at the 
bottom of the PX3 spectrum screen) to -120 dBm. 


#RST (Reset the PX3, SET only) 


Forces a power-on reset. 
#RVM (Main Firmware Revision, GET only) 


RSP format: #RVMNN.NN; where NN.NN is the firmware revision, e.g. 01.23. 


#SCL (Scale, GET/SET) 

SET/RSP format: fSCLnnn; where nnn is the scale (the difference in dB between the top and bottom of 
the spectrum screen), between 010 and 080 dB. Example: #SCL080; sets the scale to 80 dB. 

#SPN (Span; GET/SET) 

SET/RSP format: #SPNxxxxxx; where xxxxxx is 000020-002000, the span in 100-Hz units. Example: 
#SPN000500; sets the span to 50 kHz. 

#TXH (Text TX hang time; GET/SET) 

SET/RSP format: fTXHnnnnn; where nnnnn is 00000-90000 milliseconds to keep the KX3 


transmitting after the last PX3 keyboard text character is sent. Example: #TXH03000; sets a 3 second 
(3000 ms) hang time. (PSK/RTTY data modes only) 


#TXM (Text TX mode; GET/SET) 


SET/RSP format: ffTXMnn; where nn is 00 (Enter key), 01 (^R/^T toggle), 02 (Any key), or 03 (Space 
key). 


#USB (USB connected state; GET only) 


RSP format: #USBn; where n is 1 (USB keyboard detected) or 2 (no keyboard detected). 


#VFB (VFO B cursor on/off; GET/SET) 


SET/RSP format: #VFBn; where n is 0 (VFO B cursor off) or 1 (VFO B cursor on). 


PX3 MACRO EXPORT/IMPORT 


Starting with firmware revision 1.48, the PX3 supports keyboard macro import and export using a USB memory 
stick/flash drive plugged into the USB port on the left side of the unit. Macros may be exported, modified and then 
imported. This feature allows easy sharing of macros between multiple PX3’s as well as custom editing of macros 
using aPC. A simple worksheet can be used to create the hexadecimal key code when creating new macros 
(included in this manual) 


Exporting Macros 
To export macros: 


e Insert a USB “thumb drive” or flash drive into the USB port on the left side of the PX3. Make 
sure the letter ‘M’ appears in the upper right hand portion of the screen. 

e Press Menu, and using the encoder, select “MSD Menu.” 

e Press the encoder knob to enter the sub-menu and rotate the encoder knob to select “XportMacr”. 

e Pressing the encoder knob will start the export. Once the macros have been exported, the message 
“Macros exported” will be displayed in the upper right corner of the screen. 


Importing Macros 
To import macros: 


e Insert a USB “thumb drive” or flash drive into the USB port on the left side of the PX3. Make 
sure the letter ‘M’ appears in the upper right hand portion of the screen. 

e Press Menu, and using the encoder, select “MSD Menu.” 

e Press the encoder knob to enter the sub-menu and rotate the encoder knob to select “ImprtMacr”. 

e Pressing the encoder knob will start the import. Once the macros have been imported, the message 
“Macros imported” will be displayed in the upper right corner of the screen. 


Macro File Format 

The exported macros/text messages are written to a file on the memory stick called “macros.txt”. Only 
macros/messages that are not empty are written out to the file. Each line constitutes one macro or message. Fields 
within the line are delimited with commas (,). Lines that begin with the ‘#’ (pound) character are ignored. This 
permits comments and other text to be added. 


number, key code, ........... Contents ........... 


number: 1 — 100 
The number determines if the entry is for macro or a text message. Valid macro numbers are 
1 - 50 while valid text message numbers are 51 - 100. 
NOTE: specifying the number of an existing macro/message will overwrite that location when 
imported. 


key code: 
The key code is a special 8 digit hexadecimal number built up using a key value and optional 
key modifiers. Special key code modifiers (Alt, Ctrl, etc.) can be added to the base key code if 
needed. For example, the F1 base key code value is 0x3A . Adding the Alt modifier of 0x200 
results in a key code of 0x23A for “AIt-F1”. 


contents: 
Up to 94 characters are allowed for text messages or macros. 


Supported USB Keyboard Codes (note: some codes may not be present on all keyboards) 


0x04 
0x05 
0x06 
0x07 
0x08 
0x09 
Ox0A 
Ox0B 
0x0C 
Ox0D 
Ox0E 
OxOF 
0x10 
0x11 
0x12 
0x13 
0x14 
0x15 
0x16 
0x17 
0x18 
0x19 
Ox1A 
Ox1B 
Ox1C 
Ox1D 
Ox1E 
Ox1F 
0x20 
0x21 
0x22 
0x23 
0x24 
0x25 
0x26 
0x27 
0x28 
0x29 
0x2A 


0x2B 
0x2C 
0x2D 
0x2E 
0x2F 
0x30 
0x31 
0x32 
0x33 
0x34 
0x35 


Keyboard a and A 
Keyboard b and B 
Keyboard c and C 
Keyboard d and D 
Keyboard e and E 
Keyboard f and F 
Keyboard g and G 
Keyboard h and H 
Keyboard i and I 
Keyboard j and J 
Keyboard k and K 
Keyboard | and L 
Keyboard m and M 
Keyboard n and N 
Keyboard o and O 
Keyboard p and P 
Keyboard q and Q 
Keyboard r and R 
Keyboard s and S 
Keyboard t and T 
Keyboard u and U 
Keyboard v and V 
Keyboard w and W 
Keyboard x and X 
Keyboard y and Y 
Keyboard z and Z 
Keyboard 1 and ! 
Keyboard 2 and @ 
Keyboard 3 and # 
Keyboard 4 and $ 
Keyboard 5 and % 
Keyboard 6 and ^ 
Keyboard 7 and & 
Keyboard 8 and * 
Keyboard 9 and ( 
Keyboard 0 and ) 
Keyboard Return (ENTER) 
Keyboard ESCAPE 
Keyboard DELETE (Backspace) 


Keyboard Tab 

Keyboard Spacebar 
Keyboard - and (underscore) 
Keyboard = and + 

Keyboard [ and { 
Keyboard ] and } 

Keyboard \ and | 

Keyboard Non-US # and ~ 
Keyboard ; and: 

Keyboard ' and " 

Keyboard Grave Accent Tilde 
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0x36 
0x37 
0x38 
Ox3A 
0x3B 
0x3C 
0x3D 
0x3E 
0x3F 
0x40 
0x41 
0x42 
0x43 
0x44 
0x45 
0x46 
0x48 
0x49 
Ox4A 
Ox4B 
Ox4C 
0x4D 
Ox4E 
Ox4F 
0x50 
Ox51 
0x52 
0x54 
0x55 
0x56 
0x57 
0x58 
0x59 
Ox5A 
0x5B 
Ox5C 
0x5D 
Ox5E 
Ox5F 
0x60 
Ox61 
0x62 
0x63 
0x64 
0x65 
0x66 
0x67 
0x68 
0x69 
Ox6A 
Ox6B 


Keyboard, and < 
Keyboard . and > 
Keyboard / and ? 
Keyboard F1 

Keyboard F2 

Keyboard F3 

Keyboard F4 

Keyboard F5 

Keyboard F6 

Keyboard F7 

Keyboard F8 

Keyboard F9 

Keyboard F10 
Keyboard Fii 
Keyboard F12 
Keyboard PrintScreen 
Keyboard Pause 
Keyboard Insert 
Keyboard Home 
Keyboard PageUp 
Keyboard Delete Forward 
Keyboard End 
Keyboard PageDown 
Keyboard RightArrow 
Keyboard LeftArrow 
Keyboard DownArrow 
Keyboard UpArrow 
Keypad / 

Keypad * 

Keypad - 

Keypad + 

Keypad ENTER 

Keypad 1 and End 
Keypad 2 and Down Arrow 
Keypad 3 and PageDn 
Keypad 4 and Left Arrow 
Keypad 5 

Keypad 6 and Right Arrow 
Keypad 7 and Home 
Keypad 8 and Up Arrow 
Keypad 9 and PageUp 
Keypad O and Insert 
Keypad . and Delete 
Keyboard Non-US \ and | 
Keyboard Application 
Keyboard Power 
Keypad = 

Keyboard F13 
Keyboard F14 
Keyboard F15 
Keyboard F16 


0x6C 
Ox6D 
Ox6E 
Ox6F 
0x70 
Ox71 
0x72 
0x73 
0x74 
0x75 
0x76 
0x77 
0x78 
0x79 
0x7A 
0x7B 
0x7C 
0x7D 
0x7E 
0x7F 
0x80 
0x81 
0x85 
0x86 
0x87 
0x88 


Keyboard F17 
Keyboard F18 
Keyboard F19 
Keyboard F20 
Keyboard F21 
Keyboard F22 
Keyboard F23 
Keyboard F24 
Keyboard Execute 
Keyboard Help 
Keyboard Menu 
Keyboard Select 
Keyboard Stop 
Keyboard Again 
Keyboard Undo 
Keyboard Cut 
Keyboard Copy 
Keyboard Paste 
Keyboard Find 
Keyboard Mute 


Keyboard Volume Up 
Keyboard Volume Down 


Keypad Comma 


Keypad Equal Sign 
Keyboard Internationali 
Keyboard International2 
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0x89 
Ox8A 
Ox8B 
0x8C 
Ox8D 
Ox8E 
Ox8F 
0x90 
0x91 
0x92 
0x93 
0x94 
0x95 
0x96 
0x97 
0x98 
0x99 
0x9A 
0x9B 
0x9C 
0x9D 
Ox9E 


Keyboard International3 
Keyboard International4 
Keyboard International5 
Keyboard International6 
Keyboard International7 
Keyboard International8 
Keyboard International9 
Keyboard LANG1 
Keyboard LANG2 
Keyboard LANG3 
Keyboard LANG4 
Keyboard LANG5 
Keyboard LANG6 
Keyboard LANG7 
Keyboard LANG8 
Keyboard LANG9 
Keyboard Alternate Erase 
Keyboard SysReg/Attention 
Keyboard Cancel 
Keyboard Clear 
Keyboard Prior 
Keyboard Return 


Key Code Worksheet 


Base key code 
NUMLOCK GUI CAPS/SHIFT  Ctrl/Alt yd ` 
0 0 Oori Oori Oori 0,1,2 or 3 
Position = 1 for NUMLOCK S 
Position = 1 for GUI 
Position = 1 for Shift or CapsLock 
Position = 1 for Ctrl, 2 for Alt or 3 for Ctrl-Alt 


To add modifier codes to an existing base key code, use the table above. For example, to 


create a key code for Alt-Shift-Y, first find the base key code for Y which is 1C and put 
those 2 digits into the cells on the right: 


NUMLOCK GUI CAPS/SHIFT Ctrl/Alt 
0 0 0 (0) 0 0 1 
Then put a 1 in the Shift cell: 
NUMLOCK GUI CAPS/SHIFT Ctrl/Alt 
0 0 0 0 1 0 1 
Then put a 1 in Alt cell: 
NUMLOCK GUI CAPS/SHIFT Ctrl/Alt 
0 0 (0) 0 1 1 1 


The new key code is: 0000111C 
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Appendix A: Change History [Applicable firmware revision shown in brackets] 


Al, 7-14-15 [01.25] 
A2, 10-8-15 [01.34] 
A3, 3-22-16 [01.42] 
A4, 7-1-16 [01.45] 

AS, 7-14-16 [01.46] 


A6, 2-13-17 [01.48] 


Original 

Added #BCI, #BCL, #BCN, #TXH, fTXM, #USB 

Added #RCF 

Added #MAA, #MBA, #MSS 

Fixed #MAA, wrong step values given for CW/DATA, added internal command 
#KBMP. 

Added macro import/export section. 


13 


